home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 501-525 / disk_516 / loom / docs / loomv1.doc < prev    next >
Text File  |  1992-05-06  |  10KB  |  366 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.          
  8.  
  9.          LOOM Version 1.0
  10.  
  11.          
  12.  
  13.          User Guide
  14.  
  15.          
  16.  
  17.          by
  18.  
  19.          Martin Kees
  20.  
  21.  
  22.  
  23.  
  24.  
  25. INTRODUCTION
  26.  
  27.  
  28.  
  29. Loom simulates an eight harness loom.  With LOOM you can 
  30. experiment with pattern design in an instant feedback 
  31. environment.
  32.  
  33.  
  34.  
  35. Load Loom from the CLI by typing:
  36.  
  37.  
  38.  
  39.   Loom
  40.  
  41.  
  42.  
  43. when in the LOOM directory or double click on the LOOM icon 
  44. from the WORKBENCH.
  45.  
  46.  
  47.  
  48. LOOM will come up in a custom 320x200 LORES screen that can be 
  49. toggled with WORKBENCH by using the Left-Amiga N and M keys.  
  50. The various rectangles you see are gadgets that allow you to 
  51. control aspects of the woven pattern.
  52.  
  53.  
  54.  
  55.                             
  56.  
  57.  
  58.  
  59. GRAND GADGET TOUR
  60.  
  61.  
  62.  
  63. THREADING BOX
  64.  
  65. Starting at the top of the screen is a large rectangle with 
  66. arrows and a slider gadget above it.  This is the THREADING 
  67. box. It controls the vertical threads or WARP threads. When 
  68. you click in the threading box you create a new warp thread of 
  69. the current color. There are eight invisible levels in the 
  70. threading box. You can see them after you click a warp thread 
  71. into existance. The thread will extend down the screen and 
  72. above it will be a small colored box. If you click above or 
  73. below the box you will see it change position.  The position 
  74. of the box selects the HARNESS that this warp thread is 
  75. attached to.
  76.  
  77.  
  78.  
  79. The threading box is a window into the full width of the 
  80. fabric we can weave. We can use the arrow buttons or slider to 
  81. scroll our view of the fabric to the left and right. When LOOM 
  82. opens memory has been set for 300 warp threads but more can be 
  83. added if needed.  The only limit is available memory in your 
  84. Amiga.
  85.  
  86.  
  87.  
  88.  
  89.  
  90. TREADLING BOX
  91.  
  92. At the right side of the screen is a vertical rectangle and 
  93. it's arrow and slider gadgets.  This is the TREADLING box. It 
  94. controls the horizontal WEFT threads.  Clicking in the treadle 
  95. box creates a weft thread or PICK of the current color.  There 
  96. are eight horizontal positions for each pick as indicated by 
  97. the small colored box.  The position of this box determines 
  98. which TREADLE or pedal was depressed when weaving this thread.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104. TIEUP BOX 
  105.  
  106. The square that connects the threading and treadling boxes is 
  107. called the TIEUP box. It is an array of 64 little squares that 
  108. can be toggled on or off by clicking on them. When a tiemark 
  109. is displayed in the tieup, it represents the linking of a 
  110. harness and a treadle. Each harness can be tied to any or all 
  111. of the eight treadles and vice versa.  The pattern of the 
  112. tieup is an important control of the fabric design.
  113.  
  114.  
  115.  
  116. The tieup is the main control for each weft thread going OVER 
  117. or UNDER a warp.  When LOOM opens, a tiemark above a treadle 
  118. causes a pick woven to pass OVER any warp whose harness is 
  119. tied to that treadle.  That behavior is called a FALLING shed, 
  120. since the warp falls below the weft thread as it crosses the 
  121. loom. 
  122.  
  123.          
  124.  
  125. A toggle of any tiemark in the tieup causes the display to 
  126. update any changes to the fabric in view.
  127.  
  128.  
  129.  
  130.  
  131.  
  132. COLOR CONTROL
  133.  
  134. Above and to the right of the tieup are color select patches. 
  135. Clicking on a color patch will cause it to be the CURRENT 
  136. color. The current color is displayed in the larger square in 
  137. the  extreme upper right corner.  Clicking in this box calls 
  138. up a color control window.  You  can change any of the default  
  139. colors by adjusting the RGB sliders in the color window. The 
  140. color window can be left open if you wish and dragged.  The 
  141. "D" box will return you to the default palette.
  142.  
  143.         
  144.  
  145.         
  146.  
  147. CLOTH DISPLAY
  148.  
  149. The last area of the screen, the large open area at the lower 
  150. left is where the design is displayed. It also is a gadget. 
  151. When you click on any threads in this area, the color of the 
  152. thread becomes the current color. This could save some mousing 
  153. mileage. No change will occur if you click in the non-thread 
  154. background area.
  155.  
  156.         
  157.  
  158.         
  159.  
  160. MENU GRAND TOUR
  161.  
  162.  
  163.  
  164. LOOM MENU
  165.  
  166. The LOOM menu controls input and output of various types. When 
  167. any subwindow is selected, a double click of the right mouse 
  168. button will display the menu bar. Every menu option has an 
  169. alternate keyboard key shortcut using the Right Amiga key. 
  170. I've tried to make them either start with the same letter as 
  171. the menu command or at least have some mnemonic relationship, 
  172. but there are oddballs.
  173.  
  174.         
  175.  
  176. NEW
  177.  
  178. New erases everything. No second chance either. SO SAVE YOUR 
  179. HARD WORK OFTEN!
  180.  
  181.     
  182.  
  183. LOAD
  184.  
  185. Load loads a loom file into the loom. When asked for the file 
  186. name include the complete path from the current directory. You 
  187. might wish to ASSIGN some directories for pattern storage to 
  188. avoid typing long file names. If the file isn't found or is 
  189. not a LOOM file, the pointer will indicate the problem. Of 
  190. course the previous LOOM contents are lost by the Load.
  191.  
  192.         
  193.  
  194. SAVE
  195.  
  196. Save saves all the current data as a LOOM file to be loaded 
  197. later on by the LOAD command. Will overwrite a file of the 
  198. same name without warning.  If you are interested in the 
  199. format of the LOOM file, read the LoomFile.doc file (Sounds 
  200. like RAP lingo?).
  201.  
  202.         
  203.  
  204. SAVE-IFF
  205.  
  206. Saves a graphic dump of the screen in IFF-ILBM format to the 
  207. given filename. Will overwrite a file of the same name without 
  208. warning. If you want to print a draft draw down use this 
  209. format to save and use one of the many IFF graphic/print 
  210. utilities to print out your design. 
  211.  
  212.   
  213.  
  214.       
  215.  
  216. PRINT
  217.  
  218. Prints a traditional draft document giving threading, tieup, 
  219. and treadling information in block format. No draw down of the 
  220. design is printed. Uses the PRT: device so preferences must be 
  221. set for your printer. Sorry no abort available.
  222.  
  223.        
  224.  
  225. QUIT
  226.  
  227. Do not pass GO, do not collect $200, just QUIT.
  228.  
  229.  
  230.  
  231.  
  232.  
  233. PREFS MENU
  234.  
  235.  
  236.  
  237. Prefs selects options for the appearance of the display. Size, 
  238. Resolution, Color, and shed-type are changed from this menu.
  239.  
  240.  
  241.  
  242. RESOLUTION
  243.  
  244. Resolution toggles the display between 320x200 LORES and 
  245. 640x400 HIRES INTERLACE. Any open subwindows will be closed 
  246. before the change and not reopened. The visible threads will 
  247. change after the resolution switch though the leftmost and 
  248. topmost threads will be maintained if possible.
  249.  
  250.  
  251.  
  252. COLOR
  253.  
  254. Color has two subitems: CONTROL which opens the color window 
  255. and DEFAULT which restores the default palette.
  256.  
  257.  
  258.  
  259. SIZES
  260.  
  261. Sizes opens the SIZE window. The size window controls the 
  262. width of the warp and weft threads. The SETT control adjusts 
  263. the spacing between the warp and weft. The three slider 
  264. controls will cause an update of the screen to reflect the new 
  265. setting. Since full screen updates take more time with tiny 
  266. settings and when in HIRES, you might want to optimize the 
  267. order you make size and resolution changes. The size window 
  268. can be left open and dragged to any convenient place on the 
  269. screen. Odd sizes will cause partial threads at the right and 
  270. bottom of the screen to not be drawn. Clicking in that area 
  271. will affect the thread to the left or above, NOT the unseen 
  272. partial. They are still present and can be scrolled into view.
  273.  
  274.  
  275.  
  276. SHED-TYPE
  277.  
  278. The two subitems select between a FALLING and RISING shed. 
  279. Note that toggling between the two is the same as looking 
  280. through to the back side of the fabric!  Changing shed-type 
  281. reverses the effect of the tiemarks in the tieup box.
  282.  
  283.  
  284.  
  285.  
  286.  
  287. MODES MENU
  288.  
  289.  
  290.  
  291. The MODES menu determines what happens when you click in the 
  292. threading and treadling boxes.
  293.  
  294.  
  295.  
  296. OVERWRITE
  297.  
  298. Overwrite is the default mode when LOOM opens. There are three 
  299. subitems in the overwrite category. Overwrite BOTH means that 
  300. a click will overwrite a thread and change it's color and 
  301. harness or treadle position. Overwrite COLOR will only change 
  302. the color of the thread, not it's harness or treadle.  
  303. Overwrite POSITION will only change the harness or treadle the 
  304. thread is associated with. The three options are mutually 
  305. exclusive. Selecting one deselects the others. Use of the 
  306. modes might make design easier in logical steps. You could 
  307. first choose the positions in BOTH mode using a constant 
  308. color. Then with COLOR selected you could go back and add 
  309. color patterns without having to worry about messing up the 
  310. positions.
  311.  
  312.  
  313.  
  314. INSERT
  315.  
  316. Insert acts like Overwrite BOTH but the new thread is inserted 
  317. into the display. The old thread at the insertion point is 
  318. pushed to the right or down. There is a full screen update 
  319. after an insert so you probably will want to insert with a 
  320. large warp and weft size setting to speed things up. Insert 
  321. deselects any other MODE.  Insert is the only way to increase 
  322. the total number of threads. More memory will only be 
  323. allocated when insert causes colored threads to extend past 
  324. the 300th warp or pick position. It is possible to die when 
  325. inserting because of memory fragmentation.  So with large 
  326. designs saving often is advised. Loading a large pattern after 
  327. a fresh boot can help avoid the fragmentation problem.
  328.  
  329.  
  330.  
  331. DELETE
  332.  
  333. Delete deletes the thread clicked on and causes all threads to 
  334. the right or below to be pulled into the gap. Delete also 
  335. triggers a full screen update and deselects any other MODE.
  336.  
  337.  
  338.  
  339.  
  340.  
  341. That completes our tour of LOOM.  I hope you find it useful 
  342. and entertaining.   LOOM 2.0 is in the planing stages. I hope 
  343. to improve editing ease with cut and paste commands, 
  344. operations on selected ranges, and add more harnesses and 
  345. treadles.  I welcome any comments or questions about LOOM.  
  346. LOOM was written in JFORTH Professional 2.0 by Delta Research. 
  347. Anyone looking for a fast and friendly programming environment 
  348. should give JFORTH a look.
  349.  
  350.  
  351.  
  352.  
  353.  
  354. Martin Kees
  355.  
  356. 1116 Road 68
  357.  
  358. Pasco, WA 99301
  359.  
  360. 509-545-6262
  361.  
  362.  
  363.  
  364.  
  365.  
  366.